home *** CD-ROM | disk | FTP | other *** search
/ PC World Interactive 7 / PC World Interactive 7.iso / pcgames / EMERGY / BC5 / EXAMPLES / OCF / COMSRVR / readme.txt
Text File  |  1997-03-25  |  2KB  |  39 lines
  1.                  Custom COM interfaces using OCF
  2.                  ===============================
  3. The MAKEFILE or .IDE file int this directory create a Dynamic
  4. Link Library (DLL) which exposes OLE custom COM interfaces and
  5. an executable (EXE) which exercises the interfaces. The files
  6. created are:
  7.  
  8.     CUSTCOM.DLL:    DLL implementing custom COM interfaces
  9.     USECOM.EXE:     EXE which exercises the interfaces
  10.  
  11. The CUSTCOM.CPP file illustrates how one can use OCF macros and
  12. its TUnknown class to implement a C++ object which exposes one
  13. or more custom COM interfaces. The macros and TUnknown class
  14. handle reference counting and implement the IUnknown members
  15. (AddRef, Release and QueryInterface) allowing you to only worry
  16. about implementing the 'actual' methods exposed by your custom
  17. interface.
  18.  
  19. USECOM.CPP shows how one can obtain a pointer to the custom COM
  20. interfaces:
  21.  
  22. (a) You may create an instance from scratch by retrieving the
  23. class factory and asking the latter to 'manufacture' the desired
  24. interface. [see CreateFromScrach() in USECOM.CPP]
  25.  
  26. (b) If you already have a pointer to one interface, you can
  27. simply use the 'QueryInterface' API to obtain a pointer to
  28. another interface since the OCF TUknown class automatically
  29. 'wires' all the interfaces exposed by your C++ object. [see the
  30. OnCommand() handler of the frame window in USECOM.CPP].
  31.  
  32.  
  33. MORE INFORMATION:  This example illustrates a case when the DLL
  34. implements one C++ object which exposes multiple OLE interfaces.
  35. With this setup, you can take advantage of OCF's default
  36. 'IClassFactory' implementation and only provide a
  37. factory callback function [see ObjectFactoryCallback() in
  38. CUSTCOM.CPP]. This rele
  39.